2.2.3. Query String parameters

[!NOTE] The request parameters are similar to those of a sales receipt, with an additional requirement to include the sales document code for the returned item: parentDocID: string, fiscal code of the sales document parentDocNum: string, fiscal number of the sales document, optional

In the case of a refund via a bank terminal with a payment application installed, additional information is transmitted in the Payments section: rrn: string , payment transaction number by bank terminal checkNum: string, check number originAmount: integer, the amount of the sale operation in kopecks

Parameter	Description	Type
documentID	The invoice code, an optional parameter (optional)	integer
docTime	Date and time of document creation, format: yyyy-MM-dd hh:mm:ss(if passed, the system checks the uniqueness by the totality of fields: docTime + docNumber + amount; if such a document has already been fiscalized, then reprinting is performed without fiscalization) (optional)	String
docNumber	Document number in the accounting system	String
wsName	Number of the cash register to be printed on the check (optional)	String
departmentName	Store name to be printed on the receipt (optional)	String
departmentCode	Point of sale code with multimerchant system (optional)	String
employeeName	Stcashier's full name	String
amount	Document amount in kopecks	String
currency	Currency name	String
items:[{…}]	List of goods/services on the invoice	Array
payments:[{…}]	Payment block array	Array
extraPayments:[{…}]	Additional payment types array	Array
fiscalID	Fiscal code of the document if the document was fiscalized (for reprint)	String
printFooter	Arbitrary lines to print at the end of the receipt (optional)	String
creditContract	Credit agreement number (required when paying on credit)	String
prepayDocID	Fiscal prepayment check code ==(mandatory when using prepayment)==	String
prepayDocNum	Prepay check number (optional)	String
clientPhone	Client phone number (optional)	String
clientName	Client name (optional)	String
tips	Tip amount in kopecks (optional)	Integer
cashback	Cashback amount in kopecks (optional)	Integer
skipReceiptPrint	Do not print terminal receipts when paying by card (optional)	Boolean
parentDocID	Fiscal code of the sales document ==(required when refund)==	String
parentDocNum	Fiscal number of the sales document ==(required when refund)== (optional)	String

items [{…}] Array

Field	Description	Type
itemId	Product/Service code in the accounting system	String
itemCodeType	Type of Product/Service code in the accounting system (optional)
itemName	Product/Service name	String
itemAttr	Ext. Attributes by position (1 - prepaid service) (optional)	Integer
itemQRCode	QR code product identification systems (optional)	Integer
itemCode	External code, classification (optional)
itemUnitCode	External packaging code (optional)
itemUnit	Unit of measure (optional)
itemBarcode	Item barcod (optional)
itemQty	Qty*1000	Integer
itemAmount	Amount to be paid in kopecks	Integer
discount	Discount amount in kopecks (optional)	Integer
discountPrc	Discount percentage (optional)	Numeric
extraData	Additional data, purpose depends on OFD (optional)	String
textToPrint	Arbitrary text that will be printed after this position on the receipt	String
itemTaxes:[{…}]	List of taxes by item	Array
itemMarginSum	The amount of the margin part in kopecks that is taxable in accordance with the percentage of taxation, while part cost price is not taxed (optional)	Integer
itemMarginPrice	Margin price (optional)

itemTaxes [{…}] Array

Field	Description	Type
taxName	Tax name	String
fullName	The full name of the tax (including the percentage), optional;By default, the receipt will print taxName + taxPrc	String
taxCode	Tax symbol (if used) (optional)	String
taxPrc	Tax percentage*100	Integer
calcType	Tax calculation type, possible values: 1 – including, 2 - fixed (excise amount*number of goods), 3 - simplified (percentage of the sale amount), Default value - 1	Integer

payments [{…}] Array

Field	Description	Type
cashAmount	Cash payment amount in kopecks	Integer
cashlessAmount	The amount of payment without cash in kopecks	Integer
creditAmount	Credit amount in kopecks	Integer
bonusesAmount	Bonus payment amount in kopecks	Integer
prepaymentAmount	Prepayment amount in kopecks	Integer
prepaymentCashlessAmount	Cashless prepayment amount in kopecks (optional)	Integer
installmentAmount	Installment amount in kopecks	Integer
invoiceAmount	The amount of non-cash payment without contacting the payment application in kopecks	Integer
rrn	Payment transaction number by bank terminal document ==(required when refund made through a bank terminal with the payment application installed)==	String
cardNumber	Number of the card used to make the payment	String
checkNum	Check number document ==(required when refund made through a bank terminal with the payment application installed)==	String
originAmount	Amount of the sale transaction in kopecks document ==(required when refund made through a bank terminal with the payment application installed)==	Integer

[!NOTE] If the system for calculating sales taxes is not used, then the itemMarginPrice and itemMarginSum parameters do not need to be passed (or null values should be passed).

extraPayments [{…}] Array

Field	Description	Type
code	Payment type code	String
amount	Payment amount in kopecks	Integer

{
  "docTime": "string, document creation date and time, format: yyyy-MM-dd hh:mm:ss (optional, if provided, the system performs uniqueness control based on the combination of fields: docTime+docNumber+amount; if such a document has already been fiscalized, reprinting is done without fiscalization)",
  "docNumber": "string, document number in the accounting system",
  "wsName": "string, cash register number for printing on the receipt, optional parameter",
  "departmentName": "string, store name for printing on the receipt, optional parameter",
  "departmentCode": "string, point of sale code in a multi-merchant system, optional parameter",
  "employeeName": "string, cashier's full name",
  "amount": "integer, document amount in kopecks",
  "currency": "string, currency name",
  "items": "list of items/services on the bill",
  [{
    "itemId": "string, item/service code in the accounting system",
    "itemCodeType": "item/service code type in the accounting system, optional parameter",
    "itemName": "string, item/service name",
    "itemAttr": "integer, additional attributes for the item (1 – prepayment service), optional",
    "itemQRCode": "QR code for item identification system, optional parameter",
    "itemCode": "external code, classification code, optional parameter",
    "itemUnitCode": "external packaging code, optional parameter",
    "itemUnit": "unit of measurement, optional parameter",
    "itemBarcode": "item barcode, optional parameter",
    "itemQty": "integer, quantity*1000",
    "itemAmount": "integer, amount to be paid in kopecks",
    "discount": "integer, discount amount in kopecks, optional parameter",
    "discountPrc": "numeric, discount percentage, optional parameter",
    "extraData": "string, additional data, purpose depends on the OFD, optional parameter",
    "textToPrint": "string, arbitrary text to be printed after this item on the receipt",
    "itemTaxes": "list of taxes per item",
    [{
      "taxName": "string, tax name",
      "fullName": "string, full tax name (including percentage), optional, by default taxName + taxPrc will be printed on the receipt",
      "taxCode": "tax symbol (if used), optional parameter",
      "taxPrc": "integer, tax percentage*100",
      "calcType": "integer, tax calculation type, possible values: 1 – inclusive, 2 – fixed (excise amount*quantity of goods), 3 – simplified (percentage of sales amount), default value - 1"
    }],
    "itemMarginSum": "integer, marginal part amount in kopecks, subject to taxation according to the tax rate, with part of the cost price not subject to tax, optional parameter",
    "itemMarginPrice": "marginal part price, optional parameter"
  }],
  "payments": {   //payment block,
    "cashAmount": "integer, cash payment amount in kopecks",
    "cashlessAmount": "integer, cashless payment amount in kopecks",
    "creditAmount": "integer, credit amount in kopecks",
    "bonusesAmount": "integer, bonus payment amount in kopecks",
    "prepaymentAmount": "integer, prepayment amount in kopecks",
    "prepaymentCashlessAmount": "integer, prepayment from non-cash funds amount in kopecks, optional",
    "installmentAmount": "integer, installment payment amount in kopecks",
    "invoiceAmount": "integer, payment amount without using a payment application in kopecks",
    "rrn": "string, transaction number for credit card payment (required when refund)",
    "cardNumber": "string, card number used for payment (required when refund)"
  },
  "extraPayments": [  //array of additional payment types
    {
      "code": "string, payment type code",
      "amount": "integer, payment amount in kopecks"
    },
  ],
  "fiscalID": "string, fiscal document code, if the document has been fiscalized (for reprinting)",
  "printFooter": "string, arbitrary lines to print at the end of the receipt (optional)",
  "creditContract": "string, credit agreement number (mandatory for credit payment)",
  "prepayDocID": "string, fiscal code of the prepayment receipt (mandatory when using prepayment)",
  "prepayDocNum": "string, prepayment receipt number (optional)",
  "clientPhone": "string, client's phone number (optional)",
  "clientName": "string, client's name (optional)",
  "tips": "integer, tips amount in kopecks (optional)",
  "cashback": "integer, cashback amount in kopecks (optional)",
  "skipReceiptPrint": "boolean, do not print terminal receipts when paying by card (optional)",
  "parentDocID": "string, fiscal code of the sales document (required when refund)",
  "parentDocNum": "string, fiscal number of the sales document (required when refund) (optional)"
}